home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / callana.arc / CALLANA.DOC next >
Text File  |  1984-10-13  |  12KB  |  249 lines
  1. @CB
  2.  
  3.  
  4.  
  5.        
  6.        
  7.                                  THE CALL ANALYZER
  8.                                     Version 1.3
  9.                         written for RBBS-PC CPC12.2A or later
  10.                                    by Lee Nelson
  11.        
  12.        
  13.        The CALL ANALYZER is copyright 1984 by AlphaSoft System,
  14.        2508 Constance  St., Atlanta, GA  30344,  phone (404) 761-8137.
  15.        
  16.        A limited  license is  granted to  distribute this  software with  the
  17.        following conditions:
  18.        
  19.                     (1)  No fee is charged for distribution
  20.                     (2)  This program is not distributed in altered form
  21.                     (3)  This statement is not removed.
  22.        
  23.        If you  find this program to be of use, please send $25 along with the
  24.        registration form  to AlphaSoft  Systems at  the  above  address.    A
  25.        registration form  has been  provided at the end of this documentation
  26.        for the  purpose of registering your copy of the CALL ANALYZER.  Users
  27.        who pay  this fee will receive a registered copy of the latest version
  28.        of the  CALL ANALYZER  at the  time of  registration.   They are  also
  29.        eligible for   telephone support for problems and questions about this
  30.        software.   In addition,  they will  receive mail  notification of the
  31.        availabiltiy of  new releases of this software.  Our technical support
  32.        line is  (404) 761-8137  after 7 PM.  We will need to know the name in
  33.        which the software was registered and the program serial number before
  34.        we can provide technical support.
  35.        
  36.        
  37.        DESCRIPTION:
  38.        
  39.        The CALL  ANALYZER program  is a  self contained  statistical analysis
  40.        program for  use in  summarizing and catagorizing the user activity on
  41.        an RBBS-PC  system.    It  is designed to work with the caller file of
  42.        any version of RBBS-PC from CPC12.2A or later.  It has been thoroughly
  43.        tested only  with CPC12.2B  and CPC12.2C.   Certain version of RBBS-PC
  44.        prior to  CPC12.2C do  not log  all of  the caller  activity that CALL
  45.        ANALYZER looks  for.   Garbage records  in the  caller files  of  some
  46.        earlier versions of RBBS can also cause problems in the CALL ANALYZER.
  47.        The only solution to this problem is to upgrade your RBBS-PC system to
  48.        CPC12.2C or later.
  49.        DISCLAIMER NOTICE:   The  CALL ANALYZER  should run on earlier version
  50.        of RBBS  prior to  CPC12.2C.   However, you  will  not  get  the  full
  51.        features of  the  system  and  Alphasoft  Systems  will  be  under  no
  52.        obligation to  support paid  users with  problems caused by files from
  53.        version earlier than CPC12.2C.
  54.        
  55.        
  56.        
  57.        REQUIREMENTS:
  58.        
  59.        The CALL  ANALYZER is  designed to  run on an IBM-PC with a minimum of
  60.        256K and  at least  1 diskette  drive.  It can be used with either the
  61.        IBM Monochrome monitor or any compatible color monitor.  In addition a
  62.        printer is  recommended to  produce hardcopy  reports.    The  printer
  63.        however is optional.  The only other requirement is a caller file from
  64.        RBBS-PC CPC12.2C or later.
  65.  
  66.  
  67.  
  68.        
  69.        
  70.        INSTALLATION:
  71.        
  72.        The CALL  ANALYZER will self install each time it is brought up unless
  73.        it is  able to  find a  valid configuration  file in  the current sub-
  74.        directory of the default disk drive.  The file, named CONFIG.ANA, will
  75.        be produced  the first  time the system is brought up.  It will prompt
  76.        the user  for certain  system specific  information. You will be asked
  77.        whether you wish to use a monochrome or color monitor and for the full
  78.        name of  your RBBS-PC caller file.  The standard name for this file is
  79.        CALLERS.   However some  users have  renamed this  file in the RBBS-PC
  80.        configuration process.      In  either case  you must  reply with  the
  81.        complete   name of your caller file.  In addition you will be prompted
  82.        for a file spec for permanent storage of the callers statistics.  This
  83.        message can  be replied  to with  either a standard DOS file name or a
  84.        DOS device  specification  such  as  a  printer,  e.g,  LPT1:,  LPT2:,
  85.        CALLDATA.DIF.   Upon exiting  the CALL  ANALYZER, you will be asked if
  86.        you wish to make a permanent copy of the statistics.  This DOS file or
  87.        device specification  will dictate  the destination  of the  permanent
  88.        copy if you should reply yes to this prompt.  This date can be sent to
  89.        a printer  or to  a file for eventual input to another program such as
  90.        LOTUS 1-2-3.
  91.        
  92.        
  93.        USE AND FUNCTIONS:
  94.        
  95.        With the caller file in the default drive and sub-directory, issue the
  96.        command CALLANA at the DOS prompt.  The startup panel will appear. The
  97.        display at  the bottom  will indicate which caller record is currently
  98.        being read.   When  this number  reaches 1, the system statistics main
  99.        screen will be displayed.  This screen is made up of 3 windows.  The 2
  100.        on the  left display statistics relating to caller information such as
  101.        baud rate, parity settings and total callers.  The other window on the
  102.        left contains statistics relating to the the RBBS  file section.   The
  103.        right window  contains a  sorted list  of all   files  that have  been
  104.        downloaded from  the system, with a total download count.  This window
  105.        can be  paged forward  or backwards using the PgUP and PgDn keys.  The
  106.        Home and  End keys  position the  window to  the bottom  or top of the
  107.        download list.
  108.        
  109.        The left window can be toggled to  display additional statistics about
  110.        the overall  utilization of  the RBBS system.  The F1 key provides the
  111.        means to toggle this window.
  112.        
  113.        To exit  the CALL ANALYZER, hit the Esc key.  At this point the system
  114.        will ask  if you wish to print the statistics.  If you wish to receive
  115.        a hardcopy  of the  statistics, simply reply with a Y.  If no hardcopy
  116.        is desired  or if the system does not have a printer a reply of N will
  117.        terminate the program.
  118.        
  119.        A menu  of all  CALL ANALYZER  keyboard functions  is displayed at the
  120.        bottom of the screen at all times.
  121.        
  122.        
  123.        LIMITATIONS AND RECOMMENDATIONS:
  124.        
  125.        Due to  the nature  of the  internal sort,  the CALL ANALYZER can only
  126.        handle caller  files with  no more  than 500  different named download
  127.  
  128.  
  129.  
  130.        files contained  therein.   The total  files downloaded  count has  no
  131.        direct bearing on this limitation.
  132.        
  133.        As a  benchmark I  have run  CALL ANALYZER against a caller file which
  134.        contained 4356 records.  This represented 436 different named download
  135.        files for a total of 879 total downloads.  This particular caller file
  136.        spanned a  period of 11 days of 24 hour operation.  System utilization
  137.        ran at  51%.   The system  contained approximatly 1200 download files.
  138.        Under standard  DOS 2.1,  the CALL ANALYZER took 2 mins and 49 seconds
  139.        to run.   Under  Multi-Job, with  2 partitions  and  RBBS-PC  CPC12.2C
  140.        running in the background, using the same caller file, the system took
  141.        4 mins  and 44  seconds to  run.   Experience with MultiLink indicates
  142.        that CALL  ANALYZER will  probably run  approximatly the same as under
  143.        Multi-Job.
  144.        
  145.        Based on  these run  times, I recommend that a caller file that is one
  146.        week (7  days) in  length is  probably ideal.   Such  a file should be
  147.        processed in a reasonable time and should not be capable of taxing the
  148.        limitations  of   the  CALL  ANALYZER.    In  addition,  if  the  user
  149.        establishes a  specific time  each week  to run  this program and then
  150.        deletes or  archives the  caller file and starts a new one, he will be
  151.        able to  compare statistics  from week to week.  The printed report is
  152.        ideal for week to week comparisons.
  153.        
  154.        
  155.        FUTURE ENHANCEMENTS:
  156.        
  157.        Currently the permanent output file from CALL ANALYZER is designed for
  158.        output to  a hardcopy  printer.  One beta tester has shown interest in
  159.        trying to  develop a  LOTUS 1-2-3 worksheet for graphing and comparing
  160.        RBBS-PC statistics.   This  permanent output data set can serve as the
  161.        source of  data into  the LOTUS  system.   If I  find that  there is a
  162.        general interest  in this,  I will develop a new output section to the
  163.        program, possibly  using the  DIF format.  Let me know if you would be
  164.        interested in seeing this.
  165.        
  166.        I will  continue to add additional features to the system from time to
  167.        time, as  well as  keep it up to date with the most current release of
  168.        RBBS-PC.   In the  future I plan to add additional statistics from the
  169.        caller file and provide some statistical peeks at the RBBS message and
  170.        user files.  If you have any ideas or suggestions that you think might
  171.        improve the  CALL ANALYZER,  please call  me voice  at (404)  761-8137
  172.        after 7:00  PM EST, call my BBS at (404) 761-3635 or write me and tell
  173.        me about  it.  I anticipate a new release of this software about every
  174.        2 or 3 months.
  175.        
  176.        
  177.        RBBS-PC is copyrighted by Tom Mack and Jon Martin, of the Capitol City
  178.        PC Users Group.  Washington, D.C.
  179.        
  180.        Multi-Job is a registered trademark of B & L Computer Software, Bosie,
  181.        Idaho
  182.        
  183.        MultiLink is a registered trademark of The Software Link, Atlanta,
  184.        Georgia
  185.        
  186.        LOTUS and 1-2-3 are registered trademarks of Lotus Development Corp.
  187.        
  188.        DIF is a trademark of Software Arts, Inc.
  189.        
  190.  
  191.  
  192.  
  193.        
  194.        
  195.        
  196.        
  197.        
  198.        
  199.                         CALL ANALYZER REGISTRATION FORM
  200.        
  201.        
  202.        To register your copy of this software please complete the form below
  203.        and return along with $25 to Alphasoft Systems,  2508 Constance St.,
  204.        Atlanta, Georgia  30344. You will receive the latest version of CALL
  205.        ANALYZER by mail within 4 weeks.  You may call our technical support
  206.        line as soon as we receive your registration form.
  207.        
  208.        
  209.        
  210.        NAME:_______________________________________________________
  211.        
  212.        ADDRESS:____________________________________________________
  213.        
  214.        CITY:_______________________________ STATE:_________________
  215.        
  216.        ZIP:____________________________
  217.        
  218.        Where did you aquire this copy of the CALL ANALYZER ?
  219.        
  220.        ____________________________________________________________
  221.        
  222.        What is the serial number under the logo of the version you now have?
  223.        __________________________
  224.        
  225.        Specify disk format you require for the new release:
  226.        
  227.          _____SS/SD  _____DS/DD 8 sector _____DS/DD 9 sector
  228.        
  229.        
  230.        Suggestions or Comments:
  231.        
  232.        ______________________________________________________________________
  233.        
  234.        ______________________________________________________________________
  235.        
  236.        ______________________________________________________________________
  237.        
  238.        ______________________________________________________________________
  239.        
  240.        ______________________________________________________________________
  241.        
  242.        ______________________________________________________________________
  243.        
  244.        ______________________________________________________________________
  245.        
  246.        ______________________________________________________________________
  247.        
  248.        ______________________________________________________________________
  249.